v2.12.1

Compare Source

Maintenance & bugfix release

• #​1631 new PlainAttribute as a workaround
• #​1632 fixed incompatibility of builders for package-private records and visibility=PUBLIC
• #​1630 fixed Staged builder's new start() incompatible with pojos etc.

What's Changed

• JDK 23+ (Upgraded build and matrix to include Java 25/javac) by @​SimY4 in #​1627

Full Changelog: immutables/immutables@2.12.0...2.12.1

v2.12.0

Compare Source

12 Anniversary Edition 🎉

maintenance & refinements

Thank you for the PRs, bug reports and feedback!

• Jackson 3 support
• New and updated website with new guides (new, all styles, all modules)
  • Same place: https://immutables.github.io/ (also redirects from http://immutables.org/)
• -Aimmutables.annotations.pick
  • maybe will finally solve javax/jakarta thing with global flag
• -Aimmutables.guava.suppress

PRs

• Jackson 3 support for Immutables by @​dkaukov in #​1615
• 1623 fix find nested element matching multiple conditions by @​harmenweber in #​1624
• Fix: fix four non-deterministic tests by @​yonghanlin in #​1625

New Contributors

• @​dkaukov made their first contribution in #​1615
• @​yonghanlin made their first contribution in #​1625

Full Changelog: immutables/immutables@2.11.7...2.12.0

v2.11.7

Compare Source

Maintenance & refinements release

Thank you for the bug reports and suggestions!

Issues

• #​1621 Version 2.11.7 tag not present on GitHub
• #​1611 Jspecify Nullable doesn't work properly with generics
• #​1612 Conflicting constructor on empty interfaces when allParameters = true, and privateNoArgConstructor = true/ protectedNoArgConstructor = true (edge case regression after #​1604)
• #​1579 TYPE_USE Nullable annotation not respected in the builder for arrays (arrays/elements annotation mirrors are missing)
  (addressed with some source code parsing, which requires -sourcepath to be provided during compilation)

PRs

• Fix .unset*() for modifiable with primitive field and default value. by @​aquariusrick in #​1606
• Remove redundant cast of optional record property wither methods by @​werli in #​1616

New Contributors

• @​aquariusrick made their first contribution in #​1606
• @​werli made their first contribution in #​1616

Full Changelog: immutables/immutables@2.11.6...2.11.7

v2.11.6

Compare Source

Maintenance & refinements release

Thank you for the bug reports and suggestions!

Issues

• #​1602 Avoid calling check/validation method twice when using plain public constructors (@Style(of = "new")
• #​1603 Fixed compilation error with staged builders and complex generics
• #​1604 parameterless constructor when there's no attributes, but allParameters=true or allMandatoryParameters=true

Full Changelog: immutables/immutables@2.11.5...2.11.6

v2.11.5

Compare Source

Maintenance & refinements release

Thank you for the bug reports and PRs!

Issues

• #​1602 @Check methods (returning void i.e. non-normalizing) now works from plain public constructors (@Style(of = "new")
• #​1583 Staged builder now works for "outside"/top-level class builders, including record builders (with *BuildStages class generated to hold stage interfaces)
• #​1598 fixed: @Data from org.immutables:datatype can be used as meta-annotation
• #​1433 additionalStrictContainerConstructor=false can be used to suppress redundant strict factory method (constructor) overload

PRs

• #​1600 Stop infinite recursion for annotations applying to themselves by @​aldexis in #​1601

New Contributors

• @​aldexis made their first contribution in #​1601

Full Changelog: immutables/immutables@2.11.4...2.11.5

v2.11.4

Compare Source

Maintenance & refinements release

Thank you for the bug reports and PRs!

Issues

• #​1597 Fixed constant defaults @Value.Default.{Int, Long, String...} were always applied for Immutable values (were ok for records)
• #​1592 When multiple annotations share the same parent annotation in passAnnotations, only one child annotation is propagated on an attribute
• #​1591 #​1521 @​Serial.AllStructural wit class retention and fixed to work as meta-annotation (on a custom style annotation etc).
• #​1588 Missing imports for classes in package names with _ (Fixed handling of $ and _ in java identifiers in import rewriter)
• #​1585 Additional way to register custom immutable annotation. Use -Aimmutables.annotation=<fqcn> for custom annotation (can have meta-styles etc)

PRs

• Fix @​param for wither for optional within a record by @​AndreiPurcaru in #​1589

New Contributors

• @​AndreiPurcaru made their first contribution in #​1589

Full Changelog: immutables/immutables@2.11.3...2.11.4

v2.11.3

Compare Source

Maintenance & refinements release

Thank you for PRs and providing feedback!

• #​1432/#​1582 JDK optional types now have first class support for having default value provided by accessor annotated with @Value.Default, no warnings are issued.
• #​1578 Fixed: missing header/package declaration in generated files with no imports
• #​1580 Fixed: with methods do not handle fallbackNullableAnnotation properly on Map types

What's Changed

• Optional with default by @​hwellmann in #​1582

Full Changelog: immutables/immutables@2.11.2...2.11.3

v2.11.2

Compare Source

Maintenance and refinement release

• #​1572 #​1573 Optimized from merging method for many supertypes
• Introduced static mode (via compile time overloads only) for from supertypes. Switch via Style.mergeFromSupertypesDynamically=false. This gives (very) old behavior before dynamic merging was introduced, for some, it is more intuitive than dynamic logic and avoid heap pollution (& ClassCastException) for some rare cases of supertypes imlementing parameterized interfaces with different actual type arguments in a hierarchy.
• #​1576 Fixed Jackson JSON deserialization for optional types (required=false was generated only for Nullable, now - for any non mandatory attribute). Generating Jackson required can be disabled via setJacksonPropertyRequired=false, the difference is if Jackson will issue an error on missing attribute or Immutables' builder will throw an exception for the same.

PRs merged

• fix: set correct override for Jackson annotation processor option by @​devinrsmith in #​1574
• Optimize mergeInternal generation with specialized methods per subtype by @​christophercolumbusdog in #​1573

New Contributors

• @​devinrsmith made their first contribution in #​1574

Full Changelog: immutables/immutables@2.11.1...2.11.2

v2.11.1

Compare Source

Maintenance and minor enhancements

• Various bugfixes: Jackson integration, refinements/fixes in withers.
• Extending Builders for records. I.e. nested static class Builder extends MyRecordBuilder {}
• Can expose *IsSet methods on builder
• new module org.immutables:datatype. It's slightly modernized version of org.immutables:data (now deprecated), no dependency on Guava, + support for records with generated builders

Also

• Include org.immutables:data in bill of materials by @​ascopes in #​1556
• GH-1557: Fix erroneous code generation for TypeTokens of raw annotated types by @​ascopes in #​1558
• Final stage builder methods' return value should be ignorable by @​benhalasi in #​1568

New Contributors

• @​benhalasi made their first contribution in #​1568

Full Changelog: immutables/immutables@2.11.0...2.11.1

v2.11.0

Compare Source

Many thanks to all contributors: PRs, testing and evaluation much appreciated!

• @Value.Builder for records on builders
  • @Value.Default.* annotation for constant default values for records and regular abstract types
  • Generated "wither" interfaces for records @Value.Builder record A(int a, String b) implements WithA {..
• JSpecify @Nullable support in @NullMarked mode.
• In general improved support for TYPE_USE annotations (as far as compiler and peculiarities of existing code allows),
• Lambda builders when using Style.attributeBuilderDetection=true: builder.value(b -> b.a(1).c(""))
• Various bugfixes and other improvements

Also

• Added support for the 'required' attribute for the generated JSON Property Annotation by @​harrismirza in #​1515
• Fix a bug with type annotation handling by @​cushon in #​1532
• simple lambda builders by @​elucash in #​1533
• Make it possible to inject annotations to "with" types by @​fp7 in #​1528
• Support Sub-Collection Queries for InMemory and MongoDB by @​markif in #​1526
• Change default Mongo UUID representation to STANDARD/v4 (Criteria) by @​mathansen in #​1482
• Use source retention for serial annotations by @​Xcelled in #​1521
• Add legacy SourceOrdering option by @​christophercolumbusdog in #​1541
• Update Generated.java to be documented. by @​ascopes in #​1543

Closed issues https://github.com/immutables/immutables/milestone/82?closed=1

New Contributors

• @​harrismirza made their first contribution in #​1515
• @​cushon made their first contribution in #​1532
• @​markif made their first contribution in #​1526
• @​mathansen made their first contribution in #​1482
• @​Xcelled made their first contribution in #​1521
• @​christophercolumbusdog made their first contribution in #​1541
• @​ascopes made their first contribution in #​1543

Full Changelog: immutables/immutables@2.10.1...2.11.0

v2.10.1

Compare Source

Maintenance release

What's Changed

• Fix 'yield outside of switch expression' by @​alsin in #​1502
• Allows NaturalOrdering for Comparable type hierarchies by @​wjglerum in #​1496

New Contributors

• @​alsin made their first contribution in #​1502
• @​wjglerum made their first contribution in #​1496

Full Changelog: immutables/immutables@2.10.0...2.10.1

v2.10.0

Compare Source

JakartaEE support

Style flag jakarta = true
Mainly package change for annotations and types like Validator

Miscellaneous

• JDK9 unmodifiable collections for List, Set, Map, style flag jdk9Collections = true
• Suppress from method, style flag from = ""
• Non-strict modifiables allows reading unset attributes, style flag strictModifiables = false
• Fixes in nested type_use annotations.
• Performance: better initial capacity for collections
• Refinements and fixes to Criteria modules
• Plus many other refinements and maintance, see below

Workarounds for Gradle

• imports for not-yet-generated types : add options.sourcepath
• disable incremental compilation (options.incremental), may also help is some complex cases

What's Changed (since some last year's release)

• guava upgrade to 30.0-jre by @​elucash in #​1422
• Fix sorting by id property with Criteria for Mongo #​1442 by @​harmenweber in #​1443
• Fix #​1424 - redundant null check in JDK maps by @​saarmbruster in #​1425
• detect the Eclipse compiler without using the TCCL by @​hwellmann in #​1452
• Experimental #​1112 requiring Enclosing annotation by @​elucash in #​1423
• Enable eclipse compiler support for Java 17 and beyond. by @​SimY4 in #​1458
• Fix toBuilder generator with generics by @​rdesgroppes in #​1460
• Populate correct initial capacity for List/Set/Map/ImmutableList.Builder by @​snazy in #​1468
• Allow specifying visibility as string by @​nastra in #​1474
• Re-try to resolve types in java.lang by @​PtrTeixeira in #​1477
• re-enable jdk9 collections support. by @​SimY4 in #​1481

New Contributors

• @​harmenweber made their first contribution in #​1443
• @​saarmbruster made their first contribution in #​1425
• @​hwellmann made their first contribution in #​1452
• @​rdesgroppes made their first contribution in #​1460
• @​snazy made their first contribution in #​1468
• @​PtrTeixeira made their first contribution in #​1477

Full Changelog: immutables/immutables@2.9.3...2.10.0

v2.9.3

Compare Source

Maintenance release

What's Changed

• #​1408 withUnaryOperator style flag/naming template by @​elucash in #​1409
• Avoid invalidating Gson type adapter cache when creating Mongo Repository by @​jmoghisi in #​1406
• fixing #​1407 - Default value with explicit null should use default. by @​SimY4 in #​1410
• Fix counts in WriteResult for upsert operation by @​dparamoshkin in #​1412

New Contributors

• @​dparamoshkin made their first contribution in #​1412
• @​chncaption made their first contribution in #​1414

Full Changelog: immutables/immutables@2.9.2...2.9.3

v2.9.2

Compare Source

Fixes (reverts to older routine) issue affecting custom immutable annotations and meta annotation discovery in some cases leading to a deadlock: processing never finishes